home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / hotfd.z / hotfd
Encoding:
Text File  |  2001-04-17  |  6.2 KB  |  130 lines
  1.  
  2.  
  3.  
  4.      HHHHOOOOTTTTFFFFDDDD((((1111MMMM))))       KKKK----SSSSppppoooooooollll bbbbyyyy XXXXiiiinnnneeeetttt ((((11110000////11114444////99999999 11110000....1111))))        HHHHOOOOTTTTFFFFDDDD((((1111MMMM))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           hotfd - hot folder daemon
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           ////uuuussssrrrr////eeeettttcccc////aaaapppppppplllleeeettttaaaallllkkkk////hhhhoooottttffffdddd [ ----DDDD | ----dddd _d_b_l_e_v ] [ ----cccc _c_o_n_f_i_g_f_i_l_e ]
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.           The _h_o_t_f_d program monitors any hot folders configured on the
  16.           system.  When files appear in the folders, it submits them
  17.           via the local printing system to the appropriate printer.
  18.           One daemon monitors all of the folders on a single machine.
  19.           Hot folders are controled by a configuration file, and are
  20.           usually created with the Xinet GUI.  _H_o_t_f_d runs as a daemon
  21.           in the background unless one of the debug options is given.
  22.  
  23.           The configuration file consists of a series of text lines
  24.           specifying the directory to watch, the printer to pass the
  25.           files to, and some options.  The format of each line is:
  26.                _d_i_r_p_a_t_h:_p_r_i_n_t_q_u_e_u_e:_o_p_t_i_o_n_s
  27.           where _d_i_r_p_a_t_h is the full local pathname to the directory,
  28.           _p_r_i_n_t_q_u_e_u_e is the name of the printer queue to which files
  29.           will be submitted, and _o_p_t_i_o_n_s is a colon-separated set of
  30.           key/value pairs (a la _p_r_i_n_t_c_a_p(5)).  Supported keys are as
  31.           follows:
  32.  
  33.           Key  Type      What it controls
  34.           as   boolean   if OPI-replacment happens, use ASCII picture format
  35.           dt   integer   number of seconds to wait for files to stop being
  36.                            modified before submitting them to the print queue
  37.           ex   string    command to use to process the files (see below)
  38.           ix   string    command to use to process standard input (see below)
  39.           jp   integer   send pictures JPEG compressed.  The value is a quality
  40.                            factor (1->99).  Setting this overrides the _a_s key.
  41.           kt   boolean   retain PC-style TIFF preview if EPS file has one
  42.           rp   string    0000 means don't replace, ffffuuuullllllll (the default) means
  43.                            replace at original resolution, else this is the
  44.                            (floating point) DPI at which to replace pictures
  46.           If there are no hot folders configured, _h_o_t_f_d will exit.
  47.           The GUI will start it if it creates any hot folders.  _H_o_t_f_d
  48.           only reads its configuration file at startup and when it
  49.           recieves a HHHHUUUUPPPP signal.
  50.  
  51.      CCCCUUUUSSSSTTTTOOOOMMMM PPPPRRRROOOOCCCCEEEESSSSSSSSIIIINNNNGGGG
  52.           If you do not want to pass the files from the hot folder to
  53.           the default printing system, you may specify two custom
  54.           processing commands instead.  _H_o_t_f_d always passes EPS and
  55.           PostScript files through a pipe to Standard Input, and
  56.           handles all other files by giving the processing command the
  57.           full pathname to the file.  So you must include both an eeeexxxx
  58.  
  59.  
  60.  
  61.      Page 1                                         (printed 1/20/100)
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.      HHHHOOOOTTTTFFFFDDDD((((1111MMMM))))       KKKK----SSSSppppoooooooollll bbbbyyyy XXXXiiiinnnneeeetttt ((((11110000////11114444////99999999 11110000....1111))))        HHHHOOOOTTTTFFFFDDDD((((1111MMMM))))
  69.  
  70.  
  71.  
  72.           and iiiixxxx command string so that all files can be processed
  73.           correctly.  When using these commands, the _p_r_i_n_t_q_u_e_u_e field
  74.           is ignored, but must contain at least one character.  Keep
  75.           in mind that OPI-replacement is nnnnooootttt performed by the _h_o_t_f_d
  76.           program.  It simply primes PostScript files with the
  77.           selected replacement options.
  78.  
  79.           These command strings are parsed much like shell commands.
  80.           Specifically, the quoting characters ", ' and \ are
  81.           interpreted as they would be by the command shell.  After
  82.           parsing, the string ``$f$'' is replaced by the full pathname
  83.           to the file being processed (and ``$F$'' is replaced by the
  84.           last component of the filename).
  85.  
  86.           An example:  if you wanted to use the LPR printing system on
  87.           IRIX instead of the default LP, you could create an entry
  88.           like the following (note that all this text must be on one
  89.           line in the hhhhoooottttffffoooollllddddeeeerrrrccccoooonnnnffff file, and the line length is
  90.           limited to 2048 bytes):
  91.               /bigdisk/submission:*:rp=150:ex=lpr -Pmyprinter $f$:
  92.                  ix=lpr -P myprinter -J "bigdisk $F$":dt#20
  93.           This entry would cause /bigdisk/submission to be watched
  94.           and, if a file there has been untouched for at least 20
  95.           seconds, it would be handed to the LPR queue mmmmyyyypppprrrriiiinnnntttteeeerrrr with
  96.           OPI-replacement set to 150 DPI.  EPS/PostScript jobs would
  97.           have their Job Name set to ``bigdisk _f_i_l_e_n_a_m_e''.
  98.  
  99.      FFFFIIIILLLLEEEESSSS
  100.           /var/adm/appletalk/hotfolderconf
  101.                Unless overridden by the ----cccc option, this file contains
  102.                the configuration of the hot folders.
  103.  
  104.           /var/adm/appletalk/hotfd_pid
  105.                Place where _h_o_t_f_d writes its PID, so it can be HHHHUUUUPPPPped.
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.      Page 2                                         (printed 1/20/100)
  127.  
  128.  
  129.  
  130.